home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / database / dperf20.zip / DPERFECT.DOC < prev    next >
Text File  |  1995-05-16  |  51KB  |  1,089 lines

  1.             ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  2.      
  3.      
  4.                         dPerfect Merge
  5.      
  6.                   Convert data base files to 
  7.              Word Perfect secondary merge files   
  8.      
  9.      Copyright 1995 Newdorf Research All Rights Reserved
  10.      
  11.               4212 North Lane, Del Mar, CA  92014
  12.      
  13.                       Barbara J. Feldman
  14.                   CompuServe ID:  73170,216  
  15.                E-mail:  73170.216@compuserve.com
  16.      
  17.              VOICE: (619) 793-8300 (ask for Barbara)
  18.                       FAX: (619) 793-9933
  19.      
  20.             ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  21.      
  22.      dPerfect Merge is a copyrighted SHAREWARE program.  You are
  23.      free to try this program for thirty days and to distribute it freely to
  24.      your friends and associates.  Please distribute the self-extracting
  25.      archive file instead of the individual files.  If you use this program
  26.      beyond the thirty day trial, you are required to register your copy.  If
  27.      you include any part of dPerfect Merge in a system for resale, you
  28.      must register each copy of dPerfect Merge.  See Page  27 for
  29.      registration details.  
  30.      
  31.            The complete shareware dPerfect Merge package contains the following:
  32.      
  33.           dPERFECT.EXE --  Interactive translation utility 
  34.           dPERFECT.DOC --  This documentation file
  35.           dPCONFIG.DBF --  Required configuration file  
  36.           dP_REGIS.TER --  Registration form
  37.           dP_READ.ME   --  A list of files in the archive  
  38.           FILE_ID.DIZ  --  Program description for BBS operators. 
  39.           VENDINFO.DIZ -- Program description for shareware vendors
  40.      
  41.      The registered version also contains:
  42.      
  43.           dPERFBV.EXE  -- Batch version of dPerfect Merge
  44.      
  45.      This program is produced by a member of the Association of Shareware
  46.      Professionals (ASP).  ASP wants to make sure that the shareware
  47.      principle works for you. If you are unable to resolve a shareware-related
  48.      problem with an ASP member by contacting the member directly, ASP
  49.      may be able to help. The ASP Ombudsman can help you resolve a
  50.      dispute or problem with an ASP member, but does not provide technical
  51.      support for members' products.
  52.      
  53.      Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  54.      49442 or send a CompuServe message via CompuServe Mail to ASP
  55.      Ombudsman 70007,3536. 
  56.      
  57.       Note: dBase is a registered trademark of Borland. Word Perfect is a
  58.      registered trademark of WordPerfect Corp. Clipper is a registered
  59.      trademark of Computer Associates.  FoxBase and FoxPro are registered
  60.      trademarks of Fox Software.
  61.                                    Table of Contents
  62.      
  63.      CREATE MERGE FILE . . . . . . . . . . . . . . . . . Page 1
  64.           "Enter path and filename of source data base file:"
  65.                       . . . . . . . . . . . . . . . . .  Page 1
  66.           "Enter key expression to create index:". . . . Page 2
  67.           "OR enter path and filename of existing index:"
  68.                       . . . . . . . . . . . . . . . . .  Page 2
  69.           "OR enter tag name of order within existing production
  70.                     .MDX index:". . . . . . . . . . . .  Page 3
  71.           "Enter record selection criteria:" . . . . . . Page 4
  72.           "There are ___ records that meet your criteria.Page 4
  73.           "Mark fields to be included with the PLUS key:"Page 5
  74.           "Want to save these parameters as a setup file? [Y/N]"
  75.                      . . . . . . . . . . . . . . . . . . Page 5
  76.           "Do you want to print a summary sheet? [Y/N]". Page 6
  77.      
  78.      CHANGE dPERFECT MERGE CONFIGURATION . . . . . . . . Page 7
  79.           Default Configuration Parameters . . . . . . . Page 7
  80.           "Word Perfect version:". . . . . . . . . . . . Page 7
  81.           "Data base compatibility:" . . . . . . . . . . Page 7
  82.           "Logical values:". . . . . . . . . . . . . . . Page 9
  83.           "Color monitor:" . . . . . . . . . . . . . . . Page 9
  84.           "European character set:". . . . . . . . . . . Page 9
  85.           Use of the Configuration File. . . . . . . . . Page 9
  86.      
  87.      REGISTRATION INFO . . . . . . . . . . . . . . . . .Page 10
  88.           "Name of Registered Owner:". . . . . . . . . .Page 10
  89.           "Registration Key:"  . . . . . . . . . . . . .Page 10
  90.           CompuServe Offer . . . . . . . . . . . . . . .Page 10
  91.           dPerfect BV. . . . . . . . . . . . . . . . . .Page 11
  92.      
  93.      USING dPERFECT MERGE. . . . . . . . . . . . . . . .Page 12
  94.           Help Screens . . . . . . . . . . . . . . . . .Page 12
  95.           Using Setup Files. . . . . . . . . . . . . . .Page 12
  96.           Versions of Word Perfect Supported . . . . . .Page 13
  97.           Using Word Perfect Merge Files . . . . . . . .Page 13
  98.           Network Capabilities of dPerfect Merge . . . .Page 15
  99.           Working Disk Space Required. . . . . . . . . .Page 15
  100.           Temporary Working Files. . . . . . . . . . . .Page 15
  101.           Minimum DOS Configuration Required . . . . . .Page 16
  102.      
  103.      Index Key Expressions . . . . . . . . . . . . . . .Page 17
  104.      
  105.      Record Selection Criteria . . . . . . . . . . . . .Page 19
  106.      
  107.      Troubleshooting Common Problems . . . . . . . . . .Page 21
  108.      
  109.      DATABASE COMPATIBILITY GUIDE. . . . . . . . . . . .Page 22
  110.      
  111.      BATCH VERSION OF dPERFECT MERGE . . . . . . . . . .Page 23
  112.           Using the Batch Version of dPerfect. . . . . .Page 23
  113.           Sample Batch File. . . . . . . . . . . . . . .Page 24
  114.      
  115.      DEFINITION OF SHAREWARE . . . . . . . . . . . . . .Page 25
  116.           DISCLAIMER - AGREEMENT . . . . . . . . . . . .Page 25
  117.      
  118.      REGISTRATION INFORMATION. . . . . . . . . . . . . .Page 27
  119.           FOR CREDIT CARD ORDERS ONLY  . . . . . . . . .Page 28
  120.           BY CHECK OR MONEY ORDER. . . . . . . . . . . .Page 29
  121.      
  122.  
  123.      
  124.                                    dPerfect Merge
  125.      
  126.      Convert data base files to Word Perfect secondary merge files
  127.      
  128.           To start the program enter dPERFECT at the DOS
  129.           command line.  If you are using a trial version, press any
  130.           key to pass the registration screen (or you will pause for 3
  131.           seconds). Answer each question followed by [Enter].   To
  132.           move between fields, use [Up arrow] and [Down arrow]. To
  133.           proceed without answering additional questions, use [F10]
  134.           to continue.  To exit to the menu at any time, use [Esc]. To
  135.           clear a response field, use [Ctrl-Y].  To select a file from a
  136.           directory listing, use [F2].  To select a field name from a
  137.           field list, use [F4].
  138.      
  139.                        CREATE MERGE FILE
  140.      
  141.      "Enter path and filename of source data base file:"
  142.      
  143.           This is the source data base which will be read and
  144.           converted to a Word Perfect secondary merge file.  This
  145.           can be any valid dBase III Plus, dBase IV, dBase 5,
  146.           Clipper, Foxbase, Foxpro or compatible data base.
  147.           Pathnames are required if your data base is not in the
  148.           current directory.  The ".DBF" extension is optional. If you
  149.           enter a filename that doesn't exist or is not a valid data
  150.           base, you will get an error message.  This is a required
  151.           field.
  152.      
  153.           To view a directory listing use [F2].  Enter the directory path
  154.           you wish to view, including a DOS file skeleton using the
  155.           wildcard characters "?" or "*". To view all files use the "*.*"
  156.           skeleton.  To view a listing of the current  directory, just
  157.           press [Enter].  To scroll through the directory listing use [Up
  158.           arrow], [Down arrow], [Home] and [End].  To select a file,
  159.           use [Enter].  To exit from the directory listing without
  160.           selecting a file, use [Esc].
  161.      
  162.           To use a previously created setup file, use [F3]. This will
  163.           recall all of your responses, such as the source data base
  164.           and the name of the merge file. For information on how to
  165.           create a setup file, see Page 5.
  166.      
  167.      "Enter key expression to create index:"
  168.      
  169.           This is an optional field.  If you wish to dynamically create
  170.           an index for your data base, enter a single field  name or a
  171.           compound key expression (e.g. STATE+CITY).  Your
  172.           merge file will be sorted on this expression.  For example,
  173.           to create mailing labels in zip code order, enter the zip
  174.           code field name from your data base.  If you enter an
  175.           invalid expression or field name, you will not exit from this
  176.           field.  Memo and logical fields are not allowed.  To  skip this
  177.           question, press [Enter]. For more examples, see "Key
  178.           Index Expressions" on Page 20.
  179.      
  180.           The index created is erased before exiting the program. To
  181.           select a field from a list of field names, use [F4].  To scroll
  182.           through the list use [Up arrow], [Down arrow], [Home] and
  183.           [End].  To select a field name from the list, use [Enter].  To
  184.           exit the list without selecting a field, use [Esc].
  185.  
  186.           To browse through your data base, use [F6].  Depending
  187.           on the size  the file, it may take a moment to build the
  188.           browse.  You can not modify your data within the browse.
  189.           To exit the browse, use [ESC].
  190.      
  191.       "OR enter path and filename of existing index:"   
  192.      
  193.           This is an optional field.  If you wish to sort your merge file
  194.           on an existing dBase III compatible index ("NDX") or an
  195.           existing Clipper index ("NTX"), enter the name of the index.
  196.      
  197.           You do not need to include the file extension. dPerfect
  198.           Merge will assume the extension ("NTX" or "NDX") based
  199.           on your default data base as chosen in "Configuration".  If
  200.           you enter a filename that does not exist, you will not exit
  201.           this field.  If you enter a filename that is not a valid index for
  202.           the default data base (chosen in "Configuration"), you will
  203.           receive an error message. You cannot enter both an index
  204.           filename and a key expression to be indexed.
  205.      
  206.           To view a directory listing use [F2].  Enter the directory path
  207.           you wish to view, including a DOS file skeleton using the
  208.           wildcard characters "?" or "*".  To view all files use the "*.*"
  209.           skeleton.  To view a listing of the current directory, just
  210.           press [Enter].  To scroll through the directory listing use [Up
  211.           arrow], [Down arrow], [Home] and [End].  To select a file,
  212.           use [Enter].  To exit the directory listing without selecting a
  213.           file, use [Esc].
  214.      
  215.           To browse through your data base, use [F6].  Depending
  216.           on the size of the file, it may take a moment to build the
  217.           browse. You can not modify your data within the browse.
  218.           To exit the browse, use [ESC].
  219.      
  220.      "OR enter tag name of order within existing production .MDX index:"
  221.      
  222.           If you have chosen dBase IV / dBase 5 as the default
  223.           database in "Configuration", you can use an order in the
  224.           production index (".MDX").  Just enter the name of the tag.
  225.           Only tags within the production index of the same name as
  226.           the source data base can be accessed.  For example, for
  227.           a data base "CLIENTS.DBF" and production index
  228.           "CLIENTS.MDX" that   contains both ZIPCODE.NDX and
  229.           LASTNAME.NDX, you may enter either "ZIPCODE" or
  230.           "LASTNAME" as the tag name of the order.
  231.      
  232.           To view a directory listing use [F2].  Enter the directory path
  233.           you wish to view, including a DOS file skeleton using the
  234.           wildcard characters "?" or "*".  To view all files use the "*.*"
  235.           skeleton.  To view a listing of the current directory, just
  236.           press [Enter].  To scroll through the directory listing use [Up
  237.           arrow], [Down arrow], [Home] and [End].  To select a file,
  238.           use [Enter].  To exit the directory listing without selecting a
  239.           file, use [Esc].
  240.      
  241.           To browse through your data base, use [F6].  Depending
  242.           on the size of the file, it may take a moment to build the
  243.           browse. You can not modify your data within the browse.
  244.           To exit the browse, use [ESC].
  245.      
  246.      "Enter path and filename of Word Perfect secondary merge file to be
  247.      created:"
  248.      
  249.           This is the name of the file to be created and is a required
  250.           field.  If the file exists, you will be prompted with a warning
  251.           message.  The file extension is optional. If you do not
  252.           specify an extension, ".SF" is used.  The merge file is
  253.           created in Word Perfect 6.0 format unless your
  254.           configuration file specifies otherwise.  For information on
  255.           changing to older versions of Word Perfect, see "Change
  256.           dPerfect Merge Configuration" on Page 7.  For more
  257.           information on using this file to create merge letters, see
  258.           "Using Word Perfect Merge Files" on Page 13.
  259.      
  260.           To browse through your data base, use [F6].  Depending
  261.           on the size of the file, it may take a moment to build the
  262.           browse. You can not modify your data within the browse.
  263.           To exit the browse, use [ESC].
  264.      
  265.      "Enter record selection criteria:"
  266.      
  267.           This is an optional field. You may enter any valid dBase or
  268.           Clipper logical expression (up to 79 characters in length).
  269.           For example, you can use record selection to only convert
  270.           records for clients whose balance is greater than zero, or
  271.           only prospects from Tennessee.  This is an advanced
  272.           feature.  If you enter an illegal expression, you will receive
  273.           an error message. (See "Record Selection Criteria" on
  274.           Page  19 for examples and legal operators).  Records that
  275.           are deleted, will not appear in the merge file. To skip this
  276.           field, just press [Enter] and each record in your source data
  277.           base file will be converted to a record in the merge file.
  278.      
  279.           To assist in creating your expression, you can use [F4] to
  280.           select from  a list of field names.  To scroll through the list
  281.           use [Up arrow], [Down arrow], [Home] and [End].  To select
  282.           from the list, use [Enter].  To exit without selecting a field,
  283.           use [Esc].
  284.      
  285.           To browse through your data base, use [F6].  Depending
  286.           on the size of the file, it may take a moment to build the
  287.           browse. You can not modify your data within the browse.
  288.           To exit the browse, use [ESC].
  289.      
  290.      "There are ___ records that meet your criteria.  Do you wish to re-enter
  291.      the criteria? [Y/N]"
  292.      
  293.           To continue with the conversion, enter [N] or [F10].  If the
  294.           number of records doesn't seem correct, enter [Y] and
  295.           verify your responses and your record selection criteria.
  296.           Deleted data base records are NOT processed.
  297.      
  298.      "Mark fields to be included with the PLUS key:"
  299.      
  300.           Field names from your data base will be displayed.  To
  301.           include a field in your Word Perfect merge file, use [+],
  302.           otherwise use [Space], [Enter], [Up arrow] or [Down arrow].
  303.           You must mark at least one field.  Memo fields are now
  304.           supported and will appear in the field list and the merge file.
  305.           The default format for date fields is MM/DD/YY format (e.g.
  306.           04/30/90).  Logical fields are converted to "YES" or "NO".
  307.           To change the format of either dates or logical values, see
  308.           "Change dPerfect Merge Configuration" on Page 7.
  309.      
  310.           To include all your database fields in the merge file, use
  311.           [F5] Include all fields.  To navigate between screens of field
  312.           names, use [Page up] and [Page down].   When you are
  313.           finished with your field selection, use [F10] Continue.
  314.      
  315.           To browse through your data base, use [F6].  Depending
  316.           on the size of the file, it may take a moment to build the
  317.           browse. You can not modify your data within the browse.
  318.           To exit the browse, use [ESC].
  319.      
  320.      "Want to save these parameters as a setup file? [Y/N]"
  321.      
  322.           If you want to re-use these responses to create a merge file
  323.           at another time, (or to use with dPerfect BV) enter [Y].  You
  324.           will then be prompted for the name of the setup file.  Do
  325.           NOT use an extension for the setup file -- dPerfect will save
  326.           the file with the extension ".MEM". You will be warned if the
  327.           setup file already exists.  A setup file will save ALL of your
  328.           responses including:
  329.      
  330.                1)  Source data base file name
  331.                2)  Expression to create index
  332.                3)  File name of existing index
  333.                4)  Word Perfect merge file name 
  334.                5)  Record selection criteria 
  335.                6)  Field selection
  336.      
  337.           A setup file, however, does NOT save any of the
  338.           parameters included in the configuration file.  To use the
  339.           setup file, see "Using Setup Files" on Page .12  A setup file
  340.           is required to use the batch version dPerfect BV (see Batch
  341.           Version of dPerfect Merge on Page 23).
  342.  
  343.      "Do you want to print a summary sheet? [Y/N]"
  344.      
  345.           A summary sheet will detail all of your responses and list
  346.           each field that you included along with its Word Perfect
  347.           field name. Word Perfect 6.0 fields are listed as FIELD(1),
  348.           FIELD(2), etc. The Word Perfect 5.1 (or 5.2) field names
  349.           are {FIELD}1~, {FIELD}2~, etc.  The older versions of Word
  350.           Perfect use field names ^F1^,^F2^ etc.  The summary
  351.           sheet is a useful tool for creating your Word Perfect primary
  352.           merge file.  It is printed to DOS port LPT1.
  353.      
  354.           In a Word Perfect 6, 5.2 ,or 5.1 primary merge file, you can
  355.           use either the numeric field names (e.g. {FIELD}1~), or
  356.           your alphanumeric data base field names (e.g.
  357.           {FIELD}zipcode~). Since WP 5.1 allows a maximum of 100
  358.           alphanumeric field names, you can mix the use of both
  359.           styles in your primary merge file.  For example, if your
  360.           dPerfect merge file has 200 field names, you can use your
  361.           data base field names for the first 100 fields, and the
  362.           numeric field names for the remaining fields. 
  363.                             CHANGE dPERFECT MERGE CONFIGURATION
  364.      
  365.           To exit from the configuration screen without saving your
  366.           changes, use [Esc] at any time.  To save your changes use
  367.           [F10], or answer "Y" to "Save Configuration".  To return all
  368.           values to the defaults, use [F5] followed by [F10].
  369.      
  370.      Default Configuration Parameters 
  371.      
  372.           Word Perfect version:    (1)  WP 6.0
  373.           Data base compatiblity:  (1) dBase III
  374.           Date format:             (1)  MM/DD/YY 
  375.           Logical values:           YES/NO
  376.           Color monitor:           (1) Color palette one
  377.           European character set:  (1)  Do not convert
  378.      
  379.      "Word Perfect version:"
  380.      
  381.           dPerfect Merge will create a 6.x compatible merge file,
  382.           unless the version parameter is otherwise.  When you first
  383.           retrieve the merge file in 5.x or 6.x, Word Perfect will
  384.           reformat for your default printer.
  385.      
  386.           In a Word Perfect 6.x primary merge file, you can select
  387.           your field names from a pick list, by naming the dPerfect
  388.           Merge secondary file as the data form.
  389.      
  390.           In a Word Perfect 5.1 or 5.2 primary merge file, you can
  391.           use either the numeric field names (e.g. {FIELD}1~), or
  392.           your alphanumeric data base field names (e.g.
  393.           {FIELD}zipcode~). Since WP 5.1 allows a maximum of 100
  394.           alphanumeric field names, you can mix the use of both
  395.           numeric and alphanumeric field names. For example, if
  396.           your dPerfect merge file has 200 field names, you can use
  397.           your data base field names for the first 100 fields, and the
  398.           numeric field names for the remaining fields.
  399.      
  400.      "Data base compatibility:"
  401.      
  402.           The default data base engine is (1) dBase III, a common
  403.           standard known as xBase consisting of  DBF, .DBT and
  404.           .NDX files.  If you are unsure of which choice to make, try
  405.           this one.
  406.      
  407.           To use Clipper index files (.NTX), choose (2) Clipper. 
  408.           Since dBase III and Clipper use compatible data base and
  409.           memo files (.DBF and  .DBT),  this choice only affects your
  410.           use of index files.
  411.      
  412.           To use dBase IV or dBase 5 data bases and index files,
  413.           choose (3) dBase IV or 5. This will allow you to use a order
  414.           within a .MDX production index.
  415.      
  416.      
  417.      "Date format:"
  418.      
  419.           The default date format is "03/30/90".  To change to
  420.           European format (e.g. "30/03/90") use option (2)
  421.           DD/MM/YY or (3) DD.MM.YY. For dates like "March 30,
  422.           1990" use option (4) Month DD, YYYY. "Logical values:"
  423.  
  424.           Logical values are converted to "YES" and "NO" unless you
  425.           specify other character strings up to a length of 8
  426.           characters each.
  427.      
  428.      "Color monitor:"
  429.      
  430.           dPerfect Merge will automatically detect whether your
  431.           monitor is color or monochrome.  Some "color" monitors,
  432.           however, only display colors as shades of gray -- making
  433.           it very difficult to view the dPerfect Merge screens in color
  434.           mode.  For these systems, choose (3) Force use of
  435.           monochrome (useful for laptops).  If you have a color
  436.           monitor, you can choose between two color palettes,
  437.           primary or pastel.
  438.      
  439.      
  440.      "European character set:"
  441.      
  442.           dPerfect Merge will convert the high Ascii characters from
  443.           decimal 128 to 175 (and 225), if you choose (2) Convert.
  444.           These are European characters, such as umlauts and
  445.           accents.  For a faster conversion, choose (1) Do not
  446.           convert.
  447.      
  448.      Use of the Configuration File
  449.      
  450.           dPerfect Merge uses dPCONFIG.DBF to save
  451.           configuration parameters and to coordinate the naming of
  452.           temporary files for multiple users.  This file must be in the
  453.           DOS path. If multiple users on a network are not all using
  454.           the same configuration (e.g. different version of Word
  455.           Perfect), each user must have his own copy of
  456.           dPCONFIG.DBF in his path.  If the configuration data base
  457.           is erased or becomes corrupted, restore it from your
  458.           original distribution disk.
  459.      
  460.                                    REGISTRATION INFO
  461.      
  462.      When you register your copy of dPerfect Merge ($26 plus shipping) you
  463.      receive:
  464.      
  465.           1)  The latest version of dPerfect Merge
  466.           2)  A printed manual
  467.           3)  FREE!! dPerfect BV -- a command-line batch utility for creating 
  468.                merge files without any user input 
  469.           4)  A registration key that will bypass the initial registration screen
  470.           5)  90 days of support via phone, fax, mail or CompuServe
  471.           6)  Notice of future upgrades 
  472.           7) A free introductory subscription to CompuServe and $15 usage
  473.                credit
  474.           8)  Discounts on "Shareware Magazine" and "Public (software)
  475.                Library News"
  476.      
  477.           To print an order form, use [F7] at the registration screen
  478.           or see Page 27.  For more information, you can contact
  479.           me:
  480.      
  481.                         Newdorf Research
  482.                         4212 North Lane
  483.                         Del Mar, CA  92014
  484.      
  485.                       Barbara J. Feldman
  486.                    CompuServe ID: 73170,216
  487.             VOICE: (619) 793-8300 (ask for Barbara)
  488.                       FAX: (619) 793-9933
  489.      
  490.      "Name of Registered Owner:"
  491.      
  492.      Enter your registration name (either an individual or a company name)
  493.      exactly as shown on your registration letter.
  494.      
  495.      "Registration Key:" 
  496.      
  497.          Enter the registration key that is provided in your registration
  498.          letter.  You will not exit this field unless you have a valid
  499.          registration key.  To exit without a registration key, leave the
  500.          field empty.
  501.      
  502.      CompuServe Offer
  503.      
  504.           FREE!! -- when you register, you are entitled to a free
  505.           introductory subscription to CompuServe Information
  506.           Service, the biggest national on-line information data base
  507.           and service.  You will receive a private user ID number and
  508.           password, a $15 usage credit (up to 2 1/2 hours connect
  509.           time), and a complimentary subscription to
  510.           CompuServe's monthly magazine.
  511.      
  512.      dPerfect BV
  513.      
  514.           FREE! -- when you register, the command-line batch utility
  515.           dPerfect BV.  This utility allows you to create merge files
  516.           without any keyboard input.  Perfect for use in menus and
  517.           custom data base systems.  Allows for the creation of
  518.           standard merge files by novices!  dPerfect BV (Batch
  519.           Version) requires the use of a setup file.  See "dPerfect BV"
  520.           on Page 23  for more information.
  521.                                      USING dPERFECT MERGE
  522.      
  523.       Help Screens
  524.      
  525.           Context-sensitive help screens are available from almost
  526.           every input field, by use of [F1].  Press any key to exit from
  527.           the help screen.
  528.      
  529.      Using Setup Files
  530.      
  531.           A setup file can be used three ways:
  532.      
  533.                1) At the command line when invoking dPerfect (the
  534.                interactive  version)
  535.      
  536.                2) At the command line when invoking dPerfect BV (Batch 
  537.                Version)
  538.      
  539.                3) From within dPerfect -- at the first prompt for  the data
  540.                base file name  by using [F3].
  541.      
  542.           To use a setup file at the command line, enter it as a /
  543.           parameter to either dPerfect or dPerfect BV on the DOS
  544.           command line. For example, to use setup file
  545.           ALLZIPS.MEM, start the program with:
  546.      
  547.           dPERFECT /allzips
  548.      or
  549.           dPERFBV /allzips
  550.      
  551.           In the interactive version, you will be given the opportunity
  552.           to change any of your responses.  To continue without any
  553.           changes, press [F10] three times.
  554.      
  555.           To recall a setup file from within dPerfect, use [F3] at the
  556.           first prompt in the Merge screen when asked "Enter path
  557.           and filename of source data base file".  You will be given a
  558.           chance to view the directory listing by using [F2] View
  559.           Directory.
  560.      
  561.           A setup file will recall ALL of your responses including:
  562.      
  563.                1)  Source data base file name 
  564.                2)  Expression name to create index
  565.                3)  File name of existing index 
  566.                4)  Word Perfect merge file name
  567.                5)  Record selection criteria
  568.                6)  Field selection
  569.      
  570.           A setup file will not save the configuration parameters
  571.           (such as Word Perfect version, or data format).  Setup files
  572.           may be used with the interactive version (dPERFECT.EXE)
  573.           but are required with the batch version (dPERFBV.EXE).
  574.           For more information on creating setup files, see "Want to
  575.           save this parameters as a setup file?" on Page 5.
  576.      
  577.      Versions of Word Perfect Supported
  578.      
  579.           The default Word Perfect version is 6.0.  To create a 5.2,
  580.           5.1, 5.0 or 4.2 compatible merge file, change the dPerfect
  581.           Merge configuration (from the main menu).  Word Perfect
  582.           5.1/5.2 merge files include data base field names --
  583.           allowing you to create primary merge files using your data
  584.           base field names.  Word Perfect 5.1 allows a maximum of
  585.           100 alphanumeric field names. Additional fields can be
  586.           accessed by their numeric field name (e.g. {FIELD}101~).
  587.           For more information, see your Word Perfect reference
  588.           manual.
  589.      
  590.      Using Word Perfect Merge Files
  591.      
  592.           dPerfect creates a Word Perfect secondary merge file. The
  593.           secondary file is the list of variable data (such as names,
  594.           addresses, phone numbers) that is merged with your fixed
  595.           data (primary file) to create form letters, mailing labels, etc.
  596.           To create the primary merge file (the actual form letter, or
  597.           mailing label format), use Word Perfect. Insert merge
  598.           codes for each variable field [Shift-F9], using either the
  599.           numeric or alphanumeric (WP 5.2/5.1 only) field name.
  600.           Using a printed summary sheet from dPerfect Merge, will
  601.           make it easier to remember the field names and numbers.
  602.      
  603.           To begin a merge from within Word Perfect 6.0 Windows,
  604.           choose Tools/Merge [Shift F9].  Choose the dPerfect
  605.           Merge secondary file as the Data File.   For ease in
  606.           creating a Form File (or primary file),  choose your dPerfect
  607.           secondary file as the "Associated Data File."
  608.      
  609.           To begin the merge from within Word Perfect for DOS, use
  610.           [Ctrl F9] [Merge] and name your secondary and primary
  611.           files. For additional information, see your Word Perfect
  612.           reference manual. Uses for dPerfect Merge include mailing
  613.           labels, personalized form letters, data base publishing,
  614.           directories, and lists. Network Capabilities of dPerfect Merge
  615.  
  616.           dPerfect Merge will operate in a network environment
  617.           allowing multiple users to access common data bases
  618.           using record locking. If your source data base is
  619.           unavailable for shared use, you will be given the
  620.           opportunity to either retry or exit.  The configuration file
  621.           dPCONFIG.DBF must be located in the DOS path.  This
  622.           file is used to coordinate the naming of temporary files
  623.           among multiple users, and stores the configuration
  624.           parameters. If individual users need to have different
  625.           dPerfect Configuration parameters, place dPCONFIG.DBF
  626.           on a local or private drive.  dPerfect Merge requires
  627.           Read/Write/Create/Delete privileges in the current directory
  628.           so that it may create and delete its temporary files.
  629.      
  630.      Working Disk Space Required
  631.      
  632.           dPerfect Merge requires approximately twice the space of
  633.           the merge file you wish to create.  For example, if your data
  634.           base is 10 MB in length and you are converting 30% of
  635.           your records to a merge file, dPerfect will require 3 MB in
  636.           temporary disk space and 3 MB for your merge file --
  637.           totaling 6 MB.
  638.      
  639.      Temporary Working Files
  640.      
  641.           dPerfect Merge creates and erases a variety of temporary
  642.           working files.  If the program is interrupted by a power
  643.           failure, or the system is rebooted while dPerfect is running,
  644.           the temporary files will NOT be erased.  The temporary
  645.           files are created in the current directory, and are named
  646.           "DPTMPxxx.*"  where xxx is a number from "000" through
  647.           "999". Minimum DOS Configuration Required
  648.      
  649.           dPerfect Merge requires DOS 3.1 or greater and 512Kb
  650.           memory.  dPerfect Merge works on dBase III Plus, dBase
  651.           IV, dBase 5, Clipper, FoxPro, FoxBase or compatible data
  652.           bases (.dbf and .dbt) and supports "ntx",  "ndx", and "mdx"
  653.           index files.
  654.      
  655.           dPerfect supports up to 1024 fields per data base and 510
  656.           selected fields per merge.  dPerfect creates secondary
  657.           merge files for either Word Perfect 6.0, 5.2,5.1, 5.0 or 4.2.
  658.           CONFIG.SYS must contain "Files=10" or greater. For more
  659.           information on CONFIG.SYS, consult your DOS manual.
  660.      
  661.           The configuration file dPCONFIG.DBF must be located in
  662.           the DOS path.  This file is used to coordinate the naming of
  663.           temporary files among multiple users, and stores the
  664.           configuration and registration parameters. If individual
  665.           users on a network need to have different dPerfect
  666.           Configuration parameters, place dPCONFIG.DBF on a
  667.           local or private drive.
  668.      
  669.      
  670.      
  671.      
  672.      
  673.                                  Index Key Expressions
  674.      
  675.      
  676.      Operator       Type      Meaning/
  677.                               Example
  678.      --------------------------------------------------------------------------- -
  679.           +         C         Concatenation
  680.                               STATE+CITY
  681.      
  682.           +         N         Addition
  683.                               TAX+AMOUNT
  684.      
  685.           +         D+N       Adds days to date
  686.                               ORDER_DATE+AR_AGE
  687.      
  688.           -         D-N       Subtracts days from date
  689.                               CL0SE_DATE-LEN_ESCRW
  690.      
  691.           -         D-D       Elapsed days between dates
  692.                               SALE_DATE-LIST_DATE
  693.      
  694.           DTOS()    D         Convert date to character
  695.                               DTOS(SALE_DATE) 
  696.      
  697.           STR()     N         Convert numeric to character
  698.                               STR(NUMBER)
  699.      
  700.           VAL()     C         Convert character to numeric
  701.                               VAL(CHAR_AMT)
  702.      
  703.      
  704.                           Be sure to consider the data type of your fields when creating a key index
  705.                expression.  Use DTOS(date_field) to convert dates to characterestype
  706.                suitable for indexing.  To create multiple level sorts, use concatenation. 
  707.                For example, to sort by state, followed by city, followed by sold date,
  708.                followed by last name and first name:
  709.      
  710.      STATE+CITY+DTOS(SOLD_DATE)+LAST_NAME+FIRST_NAME
  711.      
  712.                               Record Selection Criteria
  713.      
  714.      Operator       Type      Meaning / Example
  715.      -------------------------------------------------------------------------
  716.           =         C,N,D          Equal to
  717.                                    ZIPCODE="92561"
  718.      
  719.       <> or #       C,N,D          Not equal to
  720.                                    STATE <> "TX"
  721.      
  722.           >         C,N,D          Greater than
  723.                                    AMOUNT > 100
  724.      
  725.           <         C,N,D          Less than 
  726.                                    AMOUNT < 100
  727.      
  728.            >=       C,N,D          Greater than or equal to 
  729.                                    AMOUNT >= 100
  730.      
  731.           <=        C,N,D          Less than or equal to
  732.                                    AMOUNT <= 100
  733.      
  734.           $         C              Contained within
  735.                                    PROD_TYPE $"1234"
  736.      
  737.           .AND.     L              True if both expressions are true
  738.                                    STATE="TX"  .AND. > 100
  739.      
  740.           .OR.      L              True if either expression is true
  741.                                    STATE="TX" .OR. AMOUNT>100
  742.      
  743.           .NOT.     L              True if expression is false
  744.                                    .NOT. STATE = "TX"
  745.      
  746.           +         N              Addition
  747.                                    AMOUNT+TAX > 1000
  748.      
  749.           +         C              Concatenation
  750.                                    FIRST+LAST="JOHNSMITH"
  751.      
  752.           +         D+N            Adds days to date
  753.                                    ORDER_DATE+10 < DATE()
  754.      
  755.           -          N             Subtraction
  756.                                    GROSS-NET>10000
  757.      
  758.           -         D-N            Subtracts daysfrom date
  759.                                    SHIP_DATE-10 <=ORDER_DATE
  760.      
  761.            -        D-D            Elapsed time between dates
  762.                                    SHIP_DATE-ORDER_DATE > 10
  763.      
  764.           *          N             Multiplication
  765.                                    AMOUNT*TAX_RATE > 1000
  766.      
  767.           /          N             Division
  768.                                    TOT_AMT/AVG_PRICE > 10
  769.      
  770.      
  771.      
  772.           Record selection criteria must be logical expressions -- 
  773.           expressions that evaluate to either .T. (true) or .F. (false).
  774.           In addition to the operators listed above, any valid Clipper
  775.           function may be used (e.g. !EMPTY(AMOUNT)) Be sure to
  776.           use consider the data type of the fields that you are
  777.           selecting.  The contents of data fields must be enclosed in
  778.           quotes. For example, if ZIPCODE is a character field:
  779.      
  780.           ZIPCODE = 90304          Not a valid expression
  781.      
  782.           ZIPCODE = "90304"        Is a valid expression
  783.      
  784.                            Troubleshooting Common Problems
  785.      
  786.       1) If you can not execute dPerfect Merge because of an "Out of Memory"
  787.      error, try adding the following to your CONFIG.SYS file:
  788.      
  789.           SET CLIPPER=/E000
  790.      
  791.      After adding this line, reboot your system and try again.  I have heard of
  792.      users with DR DOS using EMS386.SYS with "FRAME=NONE" having
  793.      this problem.  Good Luck!
  794.      
  795.      2) If your database has high Ascii European characters, you MUST
  796.      CHOOSE the conversion option (2) in Configuration.  Otherwise,
  797.      WordPerfect will  interpret these characters as control codes, with
  798.      unpredictable results!
  799.      
  800.      3) dPerfect Merge will not work with fields or filenames that begin with a
  801.      numeric character (e.g. "1TEST.DBF"  or "1STNAME").
  802.      
  803.      4) dPerfect Merge is not compatible with partial indices in dBase III mode.
  804.      
  805.      5) dPerfect Merge is only compatible with .DBT memo files.  Others are
  806.      not supported.
  807.      
  808.                              DATABASE COMPATIBILITY GUIDE
  809.      
  810.      
  811.                   data base          index          memo
  812.                     file       OK?   file     OK?   file   OK?
  813.      
  814.      
  815.      
  816.      dBase III Plus  .dbf       Y   .ndx      Y    .dbt    Y
  817.      (Borland)
  818.      
  819.      
  820.      Clipper        .dbf        Y    .ntx      Y    .dbt    Y
  821.      (Computer Associates)
  822.      
  823.      
  824.      dBase IV/5     .dbf        Y    .mdx      Y    .dbt    Y
  825.      (Borland)                (note 1)
  826.      
  827.      
  828.      Fox Base      .dbf         Y                   .dbt    Y
  829.      
  830.      Fox Pro2      .dbf         Y    .ndx      Y    .fpt  (note 3)
  831.                                      .idx      N
  832.                                      .cdx      N
  833.      
  834.      
  835.      Alpha 4      .dbf          Y    .ndx        (note2)
  836.      
  837.      
  838.      PC-File      .dbf          Y    .ndx      N    .dbt Y
  839.      v5.0 & db & 6.5 
  840.      (Buttonware)
  841.      
  842.      
  843.      
  844.      Note 1: dBase IV or 5 .ndx index is only supported as a tag within a production .MDX file.
  845.      For a database without memo fields and no float type fields, try specifying it as dBase
  846.      III to use a single .NDX file .   Also note that dBase 5 Paradox files are NOT supported.
  847.      
  848.      Note 2: Conditional indices (index keys that contain filter conditions) are not compatible.
  849.      Other indices are compatible.
  850.      
  851.      Note 3: Data bases with memo fields (.fpt files) are not compatible.  All others are
  852.      compatible.                  BATCH VERSION OF dPERFECT MERGE
  853.      
  854.      The Batch Version of dPerfect Merge (dPerfBV.EXE) is not a shareware
  855.      product, but is included in all registered versions of dPerfect Merge. 
  856.      dPerfect BV (Batch Version) does the conversion in batch mode, and
  857.      does not require any keyboard input. dPERFECT BV uses a setup file to
  858.      specify all the input parameters. It is designed to be called from a DOS
  859.      batch file, from a DOS menu or from any program that can run external
  860.      .EXE files.  It allows a programmer to integrate dPerfect Merge into a
  861.      customized system, without training the end-user on dPerfect Merge. 
  862.      dPERFBV will clear the screen before executing, and restore the original
  863.      screen upon exit.
  864.      
  865.      Using the Batch Version of dPerfect (dPERFBV.EXE)
  866.      
  867.      To create a setup file for dPerfect BV, first use the interactive version
  868.      (dPERFECT.EXE) and save your input as a setup file.  After the setup file
  869.      has been saved, call dPERFBV from the DOS command line or in a
  870.      batch file.  Remember, the setup file is a required parameter.  For
  871.      example:
  872.      
  873.      dPERFBV /setup
  874.      
  875.      dPerfect BV sets the DOS ERRORLEVEL as follows:
  876.      
  877.           ERRORLEVEL = 1 Successful completion
  878.           ERRORLEVEL = 2 Fatal error
  879.      
  880.      If there is an error, the user is warned as to the type of error -- and is
  881.      prompted to "Press Return To Continue".  This is the only user input that
  882.      is required.  When there is a successful completion, the user is returned
  883.      to the calling program (without requiring any user keystrokes).   
  884.      
  885.      WARNING: dPerfect BV does NOT warn before writing over an existing
  886.      merge file.  Sample Batch File (dP_BTEST.BAT):
  887.      
  888.      ECHO OFF
  889.      CLS
  890.      ECHO  This batch file assumes a setup file named "TEST"
  891.      ECHO  otherwise, the merge file will not be generated.
  892.      PAUSE 
  893.      dperfbv /test
  894.      CLS
  895.      IF ERRORLEVEL 2 GOTO no_wp
  896.      ECHO  Creation of merge file successful! 
  897.      ECHO  Word Perfect can be started with a macro that
  898.      ECHO  will do the merge.  The following assumes that 
  899.      ECHO  the macro is named "MERGE". 
  900.      PAUSE wp /m-merge
  901.       GOTO end
  902.      :no_wp 
  903.      ECHO   An error prevented the creation of the merge file.
  904.      PAUSE
  905.      :end
  906.      
  907.                                DEFINITION OF SHAREWARE
  908.      
  909.      Shareware distribution gives users a chance to try software before buying
  910.      it. If you try a Shareware program and continue using it, you are expected
  911.      to register.  Copyright laws apply to both Shareware and commercial
  912.      software, and the copyright holder retains all rights, with a few specific
  913.      exceptions as stated below.  Shareware authors are accomplished
  914.      programmers, just like commercial authors, and the programs are of
  915.      comparable quality. (In both cases, there are good programs and bad
  916.      ones!) The main difference is in the method of distribution.  Shareware
  917.      is a distribution method, not a type of software. You should find software
  918.      that suits your needs and pocketbook, whether it's commercial or
  919.      Shareware. The Shareware system makes fitting your needs easier,
  920.      because you can try before you buy. And because the overhead is low,
  921.      prices are low also. Shareware has the ultimate money-back guarantee
  922.      -- if you don't use the product, you don't pay for it.
  923.      
  924.                     DISCLAIMER - AGREEMENT
  925.      
  926.      Users of dPerfect Merge must accept this disclaimer of warranty:
  927.      "dPerfect Merge is supplied as is.  The author disclaims all warranties,
  928.      expressed or implied, including, without limitation, the warranties of
  929.      merchantability and of fitness for any purpose. The author assumes no
  930.      liability for damages, direct or consequential, which may result from the
  931.      use of dPerfect Merge."
  932.      
  933.      dPerfect Merge is a "shareware program" and is provided at no charge
  934.      to the user for evaluation.  Feel free to share the self-extracting archive
  935.      file with your friends, but please do not give it away altered or as part of
  936.      another system.  The essence of "user-supported" software is to provide
  937.      personal computer users with quality software without high prices, and
  938.      yet to provide incentive for programmers to continue to develop new
  939.      products.
  940.      
  941.      If you find this program useful and find that you are using dPerfect Merge
  942.      and continue to use dPerfect Merge after a 30 day trial period, you must
  943.      make a registration payment of $29 to Newdorf Research.  The $29
  944.      registration fee will license one copy for use on any one computer at any
  945.      one time.  
  946.      
  947.      Commercial users of dPerfect Merge must register and pay for their
  948.      copies of dPerfect Merge within 30 days of first use or their license is
  949.      withdrawn.  Site-License arrangements may be made by contacting
  950.      Newdorf Research.  Anyone distributing dPerfect Merge for any kind of
  951.      remuneration must first contact Newdorf Research at the address below
  952.      for authorization. This authorization will be automatically granted to
  953.      distributors recognized by the (ASP) as adhering to its guidelines for
  954.      shareware distributors, and such distributors may begin offering dPerfect
  955.      Merge immediately.  (However Newdorf Research must still be advised
  956.      so that the distributor can be kept up-to-date with the latest version of
  957.      dPerfect Merge.)
  958.      
  959.      You are encouraged to pass a copy of dPerfect Merge along to your
  960.      friends for evaluation.  Please distribute the self-extracting archive file
  961.      (rather than individual files) and encourage them to register their copy if
  962.      they find it useful.  All registered users will receive a copy of the latest
  963.      version of dPerfect Merge, a printed manual and a registration key that
  964.      will bypass the initial registration screen.
  965.      
  966.      
  967.      
  968.                        dPerfect Merge REGISTRATION INFORMATION
  969.      
  970.      When you register your copy of dPerfect Merge ($26 plus shipping) you
  971.      receive:
  972.      
  973.           1)  The latest version of dPerfect Merge
  974.      
  975.           2)  A printed manual
  976.      
  977.           3)  FREE!! dPerfect BV -- a command-line batch utility for creating
  978.      merge files without any user input
  979.      
  980.           4)  A registration key that will bypass the initial registration screen
  981.      
  982.           5)  90 days of support via phone, fax, mail or CompuServe
  983.      
  984.           6)  Notice of future upgrades 
  985.      
  986.           7)  A free introductory subscription to CompuServe and $15 usage
  987.      credit
  988.      
  989.           8)  Discounts on "Shareware Magazine" and "Public (software)
  990.      Library News"
  991.      
  992.           9) Extra!  Extra! For registered users only, the complete collection
  993.      of ASP shareware (updated quarterly) on CD-ROM. Only $25.
  994.      
  995.      Site-License arrangements may be made by contacting Newdorf
  996.      Research.  U$ funds on US banks only, please. Use the following order
  997.      form.
  998.                       Barbara J. Feldman
  999.                        Newdorf Research
  1000.                         4212 North Lane
  1001.                       Del Mar, CA  92014
  1002.          VOICE:  (619)793-8300     FAX:    (619)793-9933
  1003.                        CIS:    73170,216
  1004.      
  1005.          **********    FOR CREDIT CARD ORDERS ONLY  **********
  1006.      
  1007.      You can order with MasterCard, Visa, American Express or Discover
  1008.      from:
  1009.      
  1010.      Public (software) Library     Voice: (800)2424-PsL
  1011.      P.O. Box 35705                Voice: (713)524-6394
  1012.      Houston, TX  77235-5705       FAX: (713)524-6398
  1013.                                    CIS: 71355,470
  1014.      
  1015.      Any questions about the status of the shipment of the order, refunds,
  1016.      registration options, product details, technical support, volume discounts,
  1017.      dealer pricing, site licenses, etc, must be directed to Barbara at Newdorf
  1018.      Research.  Thank you!
  1019.      
  1020.      ************   FOR COMPUSERVE USERS ONLY  **********
  1021.      
  1022.           Order on-line and charge the fees to your CompuServe
  1023.                account.  Just GO SWREG and search for "dPerfect".
  1024.                       *******************
  1025.                              TO REGISTER dPERFECT MERGE
  1026.                     BY CHECK OR MONEY ORDER
  1027.      
  1028.      Pricing   1- 10:      $26 + Shipping    
  1029.      
  1030.                Disk Size:  [  ] 5 1/4"    [  ] 3 1/2"
  1031.      
  1032.      Quantity:_________  X  $ 26             $________
  1033.      
  1034.      California Sales Tax (7.00%)            $________
  1035.      
  1036.      Shipping/HandlingQTY: ______ X $______  $______
  1037.      
  1038.           [ ] U.S. $3.00 each
  1039.           [ ] Mexico/Canada  $4.00 each
  1040.           [ ] Other Foreign  $7.00 each
  1041.      
  1042.      P.O. Surcharge   QTY: ______ X $2.00         $________
  1043.           (U.S. only -- for government agencies, universities,  and
  1044.                Fortune 500 companies)
  1045.      
  1046.      EXTRA!!! ASP CD-ROM of Shareware!! 
  1047.           Only $25                               $________
  1048.           (may be shipped separately to insure you the lastest
  1049.                quarterly release!)
  1050.      
  1051.                      Total Enclosed              $________
  1052.      
  1053.      Send check or money order (in US funds drawn on US bank, please)
  1054.      to:
  1055.      
  1056.                        Newdorf Research
  1057.                        4212 North Lane
  1058.                        Del Mar, CA 92014
  1059. Name of Registered Owner:_______________________________________________
  1060. (list name or company exactly as you wish it to appear on the screen)
  1061.  
  1062. Contact Person:__________________________________________________________
  1063.  
  1064.  
  1065. Company:__________________________________________________________________
  1066.  
  1067.  
  1068. Address:__________________________________________________________________
  1069.  
  1070.  
  1071. City:______________________________________________________________________
  1072.  
  1073.  
  1074. State:______________________Zip:_______________________
  1075.  
  1076. Country:____________________________________________________________________
  1077.  
  1078.  
  1079. Phone: (_________)________________________________________
  1080.  
  1081. eMail address or CompuServe User ID:_________________________________________
  1082.  
  1083. Where did you get your copy of dPerfect Merge?________________________________
  1084.  
  1085. Comments and Suggestions:_____________________________________________________
  1086.                   
  1087.  
  1088.  
  1089.